GET Hero Detail
/openmlbb/mlbb/heroes/{hero_identifier}
API Path: /api/heroes/{hero_identifier}
Get detailed information for a specific hero by ID or name. Supports query parameters for pagination and localization.
Path parameters:
- hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like
30,Yi Sun-shin, oryisunshin.
Query parameters:
- size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes hero details:
- records: Array of hero entries, each containing:
- _id: Unique record identifier.
- caption: Caption or localized label.
- configId: Configuration ID.
- createdAt: Creation timestamp.
- createdUser: Creator username.
- data:
- head: Hero portrait image URL.
- head_big: Larger hero portrait image URL.
- hero:
- data:
- heroid: Hero ID.
- name: Hero name.
- story: Hero lore or background story.
- painting: Hero splash art image URL.
- speciality: Array of hero specialties (e.g., Support, Crowd Control).
- abilityshow: Array of ability stats.
- difficulty: Difficulty rating.
- heroskilllist: Array of skill sets, each containing:
- skilllist: Array of skills:
- skillid: Skill ID.
- skillname: Skill name.
- skilldesc: Skill description.
- skillicon: Skill icon URL.
- skillcd&cost: Cooldown and mana cost.
- skilltag: Array of tags:
- tagid: Tag ID.
- tagname: Tag name (e.g., Burst, CC).
- tagrgb: Tag color.
- skillvideo: Skill video URL (if available).
- skilllist: Array of skills:
- roadsort: Lane assignment metadata:
- road_sort_id: Lane ID.
- road_sort_title: Lane title (e.g., Mid Lane).
- road_sort_icon: Lane icon URL.
- sortid: Role assignment metadata:
- sort_id: Role ID.
- sort_title: Role title (e.g., Mage).
- sort_icon: Role icon URL.
- smallmap: Hero smallmap image URL.
- squarehead: Square portrait image URL.
- squareheadbig: Larger square portrait image URL.
- data:
- hero_id: Unique hero identifier.
- relation:
- assist:
- desc: Description of assist synergy.
- target_hero_id: Array of hero IDs assisted.
- target_hero: Array of assisted hero metadata (images).
- strong:
- desc: Description of heroes countered.
- target_hero_id: Array of hero IDs countered.
- target_hero: Array of countered hero metadata (images).
- weak:
- desc: Description of heroes that counter this hero.
- target_hero_id: Array of hero IDs that counter.
- target_hero: Array of counter hero metadata (images).
- assist:
- url: Official lore or profile URL.
This endpoint is useful for:
- Displaying comprehensive hero profiles.
- Analyzing hero abilities and skill tags.
- Understanding hero synergies and counters.
- Linking lane and role assignments to gameplay analysis.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.mlbb.hero_detail("miya", size=20, index=1, lang="en")
print(response)
Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| hero_identifier | path | string | yes | - |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |